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Presentación 


Presentación de GitBook 
Origen 

GitBook fue publicado como proyecto en el año 2014 bajo una licencia Apache 2.0, con el objetivo de conseguir una 
solución simple y moderna para la gestión de nuestra documentación. Está desarrollado con JavaScript como una 
librería de NodeJS, y puede ser usado desde la línea de comandos. 

Situación actual 

Tal y como se indica en el proyecto en Github, a día de hoy el equipo de desarrolladores original de este proyecto 
está trabajando en Gitbook.com, por lo que el proyecto original ya no se está actualizando. 

Ventajas 

• Los contenidos se guardan en un formato basado en texto plano, como es markdown o asciidoc, lo que facilita su 
tratamento de forma aislada, o con un editor externo diferente a GitBook. 

• Exportación simple y rápida a otros formatos (HTML, PDF, ePUB...) 

• Integración con un sistema de control de versiones. Publicación automática en la nube. 
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Instalación 


Instalación de GitBook 
GNU/Linux 

Para proceder con la instalación de GitBook debemos ejecutar los siguientes comandos: 

Ubuntu 18.04 (bionic beaver) 


# apt install nodejs npm 

# npm install -g gitbook gitbook-cli doctoc 


Primer proyecto 

Si queremos crear un primer proyecto vacío en el directorio actual: 


$ gitbook init 


Sitio estático 

Para crear el contenido estático en formato HTML en un subdirectorio _book : 


$ gitbook build 


Servidor local 

Para poder visualizar el contenido creado en el paso anterior, iniciamos un servidor local 


$ gitbook serve 

Starting server . .. 

Serving book on http://localhost:4000 


Vídeos 


Instalación de nodejs y npm 



II 


Instalación 


nodejs install 


.04.1 [9184 B] 

Get:24 http://archive 
4.1 [359 kB] 

Get:25 http://archive 
4.1 [133 kB] 

Get:26 http://archive 
4.1 [288 kB] 

Get:27 http://archive 
04.1 [126 kB] 

Get:28 http://archive 
8.04.1 [42.5 kB] 
Get:29 http://archive 
.1 [11.6 kB] 

Get:30 http://archive, 
18.04.1 [133 kB] 
Get:31 http://archive 
18.04.1 [2381 kB] 
Get:32 http://archive 
[7463 kB] 

Get:33 http://archive, 

B] 

Get:34 http://archive, 
ul-18.04.1 [1468 kB] 


vagrantQubuntu-bionk: * 

vagrantOubuntu-biorec - 100x24 


□ X 


ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 
ubuntu.com/ubuntu 


bionic-updates/main amd64 
bionic-updates/main amd64 
bionic-updates/main amd64 
bionic-updates/main amd64 
bionic-ifctetes/main amd64 
bionic-iM 

bionic-updates/main amd64 
bionic-updates/main amd64 
bionic-updates/main amd64 
bionic-updates/main amd64 
bionic-updates/main amd64 


libasan4 amd64 7.4.0-lubuntul-18.0 
liblsanO amd64 8.3.0-6ubuntul~18.0 
libtsanO amd64 8.3.0-6ubuntul~18.0 
libubsan0 amd64 7.4.0-lubuntul~18. 
libcilkrtsS amd64 7.4.0-lubuntul-l 
libmpx2 amd64 8.3.0-6ubuntul~18.04 
libquadmath0 amd64 8.3.0-6ubuntul~ 
libgcc-7-dev amd64 7.4.0-lubuntul-| 
gcc-7 amd64 7.4.0-lubuntul~18.04.1 
gcc amd64 4:7.4.0-lubuntu2.3 [5184 
libstdc++-7-dev amd64 7.4.0-lubunt 


'1468 kB 


Instalación de Gitbook y DocToc 
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Instalación 


gitbook install 


v»9rantQubuntu-btonk: - - a * 

vagrdntOubuntu-b4onic: - 100x24 

npn 7:1:1? depre; ited nininatch@2.0.10: Please update to nininatch 3.0.2 or higher to avoid a RegExp D 
oS í ssue 

npn deprecated sprlntf@0.1.5: The sprlntf package Is deprecated In favor of sprlntf-js. 

npn TOÜj deprecated datauri@0.2.1: Dataurl 2.0 released. See nore in https://github.con/data-url/dat 
auri/releases/tag/v2.0.O 


node-uuid@1.4.8: Use uuid nodule instead 

hawk@l.l.l: This nodule noved to @hapi/hawk. Please nake sure to switch over as 


this distribution is no longer supported and nay contain bugs and critical security issues. 


npn 




sntp@0.2.4: This nodule noved to @hapi/sntp. Please nake sure to switch over as 
this dis tribution is no longer supported and na^^ntain bugs and critical security issues. 

cryptiles@0.2.2: This versiS ^^een deprecated in accordance with the hapi su 
.Ipport policy (hapi.in/support). Please upgrade ^^atest versión to get the best features, bug f 
M ixes, and security patches. If you are unable t(P^grade at this tiñe, paid support is available for 
P olderversions (hapi.in/connercial). 

npn dept ited boon@0.4.2: This versión has been deprecated in accordance with the hapi support 
policy (hapi.in/support). Please upgrade to the latest versión to get the best features, bug fixes, 
and security patches. If you are unable to upgrade at this tiñe, paid support is available for olde 
r ve rsio ns (hapi.in/connercial). 

npn 7:1 :K' deprecated hoek@0.9.1: This versión has been deprecated in accordance with the hapi support 
policy (hapi.in/support). Please upgrade to the latest versión to get the best features, bug fixes, 
and security patches. If you are unable to upgrade at this tiñe, paid support is available for olde 

r versions (hapi.in/connercia l). __ 

loadDep:tnp -* resolveHith B ||| 
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Ejemplo práctico 


Ejemplo práctico 
Estructura 


|- - README.md 
|-- SUMMARY.md 
|-- capitulo-1 
|-- captiulo-2 

|-- capituloi-N.md 
|-- .gitignore 
|-- .gitlab-ci.yml 
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DocToc 


índice de contenidos con DocToc 


Con esta utilidad seremos capaces de crear de forma automática una tábla de contenidos en un documento con 
formato markdown. Tan solo tendremos que insertar las etiquetas correspondientes en el punto donde deseemos que 
aparezca dicho índice. 

Etiquetas 

Por defecto, la tabla de contenidos se sitúa al comienzo del documento, y recoge los nombres de los títulos que 
aparecen en el resto de documento. 

<!-- START doctoc --> 

<!- - END doctoc --> 


A continuación, ejecutamos el seguinte comando para que se anada de forma automática este índice: 


$ doctoc <fichero> --gitlab --title '## índice de contenidos' 


Más información 

Repositorio en Github 
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Exportar a otros formatos 


Exportar a otros formatos 
Requisitos previos 

Para poder ejecutar los siguientes comandos tenemos que tener instalado el aplicativo Calibre, y así poder hacer uso 
de la utilidad ebook-convert . 

Conversión a ePub 

$ gitbook epub ./ ./mybook.epub 


Conversión a PDF 


$ gitbook pdf ./ ./mybook.pdf 


Conversión a Mobi 


$ gitbook mobi ./ ./mybook.mobi 
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Publicar en la nube 


Publicación en la nube 


Gracias a los servicios que nos ofrece GitLab, podemos configurar nuestros proyectos para que se ejecuten trabajos 
de Cl cada vez que se haga un cambio en el contenido ( git push ). 

Tan solo tenemos que añadir el siguiente fichero .gitiab-ci.ymi en nuestro proyecto: 


# requiring the environment of NodeJS 8.9.x LTS (carbón) 
image: node:8.9 

# add 'node_modules' to cache for speeding up builds 
cache: 

paths: 

- node_modules/ # Node modules and dependencies 
before_script: 

- npm install gitbook-cli -g # install gitbook 

#- gitbook fetch latest # fetch latest stable versión 
#- gitbook install # add any requested plugins in book.json 
#- gitbook fetch pre # fetch latest pre-release versión 
#- gitbook fetch 2.6.7 # fetch specific versión 

- gitbook fetch 3.2.3 

- gitbook install 

test: 

stage: test 
script: 

- gitbook build . public # build to public path 
only: 

- branches # this job will affect only the 'master' branch 
except: 

- master 

# the ’pages' job will deploy and build your site to the 'public' path 
pages: 

stage: deploy 
script: 

- gitbook build . public # build to public path 
artifacts: 

paths: 

- public 

expire_in: 1 week 
only: 

- master # this job will affect only the 'master' branch 
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